home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / misc / math / TimeCalc14.lha / TimeCalc.doc < prev    next >
Encoding:
Text File  |  1996-09-26  |  3.4 KB  |  115 lines
  1.                               TimeCalc 1.4
  2.  
  3.                           25th September 1996
  4.  
  5.              ----------------------------------------------
  6. Description
  7. ~~~~~~~~~~~~
  8. TimeCalc allows you to add together a list of times easily and quickly.
  9. eg.  running lengths of films, or CD tracks
  10.  
  11. Quick example:
  12.     3:28     ->    3:28 |  0:03:28
  13.     4:11     ->    7:39 |  0:07:39
  14.     3:05     ->   10:44 |  0:10:44
  15.     4:35     ->   15:19 |  0:15:19
  16.     4:31     ->   19:50 |  0:19:50
  17.  
  18.  
  19.              ----------------------------------------------
  20. Usage
  21. ~~~~~
  22. TimeCalc has two different methods of operation.  Either manual entry of
  23. the times, or reading the list from a file.
  24.  
  25. Reading the file is basiclly the same as typing in the numbers, but it's
  26. just done in advance, so the following conditions apply.
  27.  
  28.  
  29. Enter numbers like this:       hh:mm:ss
  30. The display is in the format:  <entry>    ->    mm:ss | h:mm:ss
  31.  
  32. Any non-numeric character can be used as a seperator between the fields
  33. of the time.  
  34.  
  35. If you don't want to enter all fields, you don't have to.  You could
  36. just have `mm:ss', or just `ss', but seeing as the program works right
  37. to left, if you want to leave out either the minutes or seconds, you
  38. must replace them with a `0'.  
  39.  
  40. eg.  `3:00:00' for three hours.
  41.  
  42.  
  43. Also, you are not limited to two characters per feild.  Say you wanted
  44. to add a group of film running lengths, you might have a list like this:
  45.  
  46. 115:00   ->  115:00 |  1:55:00
  47. 123:30   ->  238:30 |  3:58:30
  48. 98:10    ->  336:40 |  5:36:40
  49. 88:59    ->  425:39 |  7:05:39
  50. 239:15   ->  664:54 | 11:04:54
  51.  
  52.  
  53. R resets the count to 0:00:00, Q quits out.  Invalid entries are ignored.
  54.  
  55. You can subtract times by entering a minus (-) sign before the time:
  56.  
  57. 40:15    ->   40:15 |  0:40:15
  58. -20:11   ->   20:04 |  0:20:04
  59.  
  60.  
  61. When reading the list of times from a file, there are two extra options
  62. available:
  63.  
  64. Q=QUICK    - This causes TimeCalc not to print entry as it is added, and
  65.              just gives a total time at the end of the list.
  66.  
  67. C=CONTINUE - If this option is present, then after the file has been
  68.              scanned, you can continue entering times by hand.
  69.  
  70.  
  71.              ----------------------------------------------
  72. History
  73. ~~~~~~~
  74.  1.0 / 1.1   - Beta copies.  Broken as hell
  75.  
  76.  1.2         - First public release
  77.  
  78.  1.3         - Internal beta
  79.               - Whoops.  1.2 thought there was 70 minutes in a hour
  80.               - Completly re-wrote maths routines.  Previous versions
  81.                 had limit on the total of 18 hours
  82.               - Now requires V37 or better
  83.  
  84.  1.4         - Second public release
  85.               - Added option to read a list from a file
  86.               - Added Continue and Quick options
  87.  
  88.  
  89.              ----------------------------------------------
  90. Notes
  91. ~~~~~
  92. #include <std_disclaimer.h>
  93.  
  94. I am very bad at writing documentation for my programs.  I know how they
  95. work becuase I wrote them.  Putting how they work into words is
  96. something I have always found difficult.
  97.  
  98. If you have any problems, please feel free to contact me.
  99.  
  100.  
  101. Special thanks to:
  102.    Kerry  - For putting up with me (Love ya)
  103.    Renze  - For not caring
  104.    Gryzor - The idea about reading from a file
  105.  
  106.  
  107.              ----------------------------------------------
  108. Contact
  109. ~~~~~~~
  110.    Dave Dustin                     Ph/Fax: +64-6-357-9283
  111.    Eclipse Software                Email:  dave@eclipsnz.manawatu.gen.nz
  112.    PO Box 4598
  113.    Palmerston North  5301
  114.    New Zealand
  115.